home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 557 / jampack4 / jampack4.doc < prev    next >
Text File  |  1991-08-05  |  8KB  |  204 lines
  1.                          +---------------------+
  2.                          | THE JAM PACKER V4.0 |
  3.                          +---------------------+
  4.  
  5.                          Release Date:  17.06.1991
  6.  
  7.  
  8.      The   JAM  Packer  is  an  executable/datafile  and  whole   disk 
  9. compression  program.   A full GEM user interface provides  convenient 
  10. and user-friendly operation.
  11.  
  12.  
  13. +------------------------+
  14. | OPERATING INSTRUCTIONS |
  15. +------------------------+
  16.  
  17.  
  18. PACK METHOD
  19. -----------
  20.      Four  compression  methods  are  implemented.
  21.  
  22. LZH -     This  is a modified version of the method used in the  first 
  23.           Lharc  series.    LZH  provides  reasonably  fast  and  very 
  24.           efficient  compression,   though  it  does  take  longer  to 
  25.           uncompress  than  any  other method  available  in  the  JAM 
  26.           packer.
  27.  
  28. LZW -     This   method   provides  fast  and   reasonably   efficient 
  29.           compression.  It has the fastest decompression speed.  It is 
  30.           ideally  suited for when fast de-compression speed  is  more 
  31.           important than smaller compressed file size (eg.  on a  hard 
  32.           disk).
  33.  
  34. V2 -      Compresses  very slowly,  but de-compression speed  is  much 
  35.           better  than LZH.   It can also compress files smaller  than 
  36.           LZW,  but not quite as good as LZH.   Since the introduction 
  37.           of  the  ICE  pack  method  into  the  JAM  packer,   V2  is 
  38.           essentially  redundant.   In  a future upgrade  it  will  be 
  39.           removed and replaced by something much better.
  40.  
  41. ICE -     This  method is used in the Pack-Ice packer and is based  on 
  42.           V2,  though it slightly improves on V2 in both time taken to 
  43.           compress,  time  taken  to de-compress and  compressed  file 
  44.           size.
  45.  
  46.  
  47. FILE PACKER
  48. -----------
  49.  
  50. PROGRAM/DATA
  51.      Two  types  of  files can be packed.   "Data"  files  are  simply 
  52.      compressed.   "Program"  files are compressed and  the  necessary 
  53.      code to de-compress and run them is included in the file.
  54.  
  55. FLASH/HEADING
  56.      If a Program file is packed,  then you can choose whether or  not 
  57.      the  screen  will "Flash" when unpacking and whether or  not  the 
  58.      "Heading" will appear when the file unpacks.
  59.  
  60.  
  61. NOTE:  Packing resource,  data,  dictionary, help or any other support 
  62.        files  for a program will cause that program to fail.   If  you 
  63.        think about it, this obviously cannot work as the program using 
  64.        these  files has no idea they're packed or how to unpack  them!  
  65.  
  66.        Also  note  that  program  files may  not  decompress  and  run 
  67.        properly from some shells (notably the Laser C shell).
  68.  
  69.  
  70. ABORTING A PACK
  71. ---------------
  72.      Holding down the ALTERNATE key during a pack will cause it to  be 
  73.      aborted.   You are not given the option of resuming, so make sure 
  74.      that when you hold down ALTERNATE, you really do want to stop the 
  75.      current pack.
  76.  
  77.      This  option also works when in the "Disk  Packer",  though  only 
  78.      when  data is being packed,  not when reading or writing  to  the 
  79.      disk.
  80.  
  81.  
  82. DISK PACKER
  83. -----------
  84.      This  option  has been updated significantly since V3.0  and  now 
  85.      works properly.
  86.  
  87.      The  "Disk  Packer"  reads in a whole disk and packs  it  into  a 
  88.      single file.  This is useful for transmission of entire disks via 
  89.      modem and archival purposes among other things.   You can  choose 
  90.      either of the four pack methods to be used during the disk  pack, 
  91.      or  alternatively  you can choose no compression from  the  "Disk 
  92.      Packer" box.
  93.  
  94. USE BOOT
  95.      If the "use boot" box is selected, the format of the disk is read 
  96.      from the boot sector.  Only use this option if you are absolutely 
  97.      sure that the disk has a valid boot sector, otherwise the results 
  98.      will be unpredictable.
  99.  
  100.      If the "use boot" option is not selected, the JAM packer attempts 
  101.      to  determine  the format of the disk by  itself.   There  is  no 
  102.      guarantee  that it will get it right,  though if any  mistake  is 
  103.      made, it will be to pack too much data, rather than not enough.
  104.  
  105. USE FAT
  106.      If this option is selected,  it is only active if the "use  boot" 
  107.      box  is  selected.   It  ensures that  data  clusters  which  are 
  108.      allocated  by the FAT (File Allocation Table) are the  only  data 
  109.      packed.  This is useful if you have deleted files from a disk, as 
  110.      although  deleted,  the  data  will  remain  on  the  disk  until 
  111.      over-written by another file.
  112.  
  113. FORMAT
  114.      This is used during a disk unpack only.   If the "format" box  is 
  115.      highlighted, the disk will be formatted to the appropriate format 
  116.      before data is written to it.
  117.  
  118.      Note:  11  sector format is not supported,  so if you  have  disk 
  119.      packed  an 11 sector a track disk,  make sure you have  formatted 
  120.      the  destination disk 11 sectors a track with a program  such  as 
  121.      Fastcopy III.
  122.  
  123. NO PACK
  124.      Select  this option when you want a fast conversion of  a  floppy 
  125.      disk into a file.  No compression is used, the data from the disk 
  126.      is just copied into a file.
  127.  
  128.  
  129. MULTI-PACKER
  130. ------------
  131.      The  "Multi-Packer"  is a handy feature when a  large  number  of 
  132.      files need to be packed.   Wildcards are supported.   Choose your 
  133.      source  directory and type in the file name template to be  used.  
  134.      Eg.  "*.*" will pack all programs in the selected directory;
  135.           "*.DAT" will pack all programs with a ".DAT" extension.
  136.  
  137. PACK PROGRAMS
  138.      If the "Program" button is selected then files with the  extender 
  139.      ".TOS",  ".TTP",  ".PRG"  or  ".APP" will be packed  as  programs 
  140.      (executables  which  will uncompress and run),  as if  they  were 
  141.      selected  individually  from  the normal pack  box  as  "Program" 
  142.      files.   Otherwise, they will be packed as data files, which will 
  143.      not automatically uncompress and run.
  144.  
  145.      The packed files overwrite the original files.
  146.  
  147.  
  148. +---------------------------------+
  149. | FILES CONTAINED IN THIS PACKAGE |
  150. +---------------------------------+
  151.  
  152. JAMPACK4.PRG   - The JAM packer program.
  153. JAMPACK4.DOC   - What you are reading now.
  154. DEPV2.S        - Assembly depack source code for V2.
  155. DEPICE.S       - Assembly depack source code for ICE.
  156. DEPLZW.S       - Assembly depack source code for LZW.
  157. DEPLZH.S       - Assembly depack source code for LZH.
  158. LDRUNLZH.S     - Trap #1 file load/depacker.
  159.  
  160.  
  161. +------------+
  162. | DISCLAIMER |
  163. +------------+
  164.  
  165. We take no responsibilty for any damage which may arise from the  use 
  166. or misuse of this program.
  167.  
  168.  
  169. +---------+
  170. | LICENSE |
  171. +---------+
  172.  
  173. You  may  make  copies and distribute this program,  as  long  as  the 
  174. program  and  documentation file remain unchanged,  and no  profit  is 
  175. obtained.
  176.  
  177. This  program is shareware.   If you find it useful,  please  send  us 
  178. something,  be it money or words of encouragement,  it doesn't matter.  
  179. Bug reports and suggestions for improvement are also welcome.
  180.  
  181. Write to us at either of the following addresses.
  182.  
  183.      +-----------------+          +-----------------------+
  184.      | Andrew Knipe    |          | Tim Knipe             |
  185.      | P.O. Box 369    |          | RSD Maiden Gully Road |
  186.      | 367 Collins St. |          | Bendigo, 3551         |
  187.      | Melbourne, 3000 |          | Victoria              |
  188.      | AUSTRALIA       |          | AUSTRALIA             |
  189.      +-----------------+          +-----------------------+
  190.  
  191.  
  192.  
  193.                               |
  194.                              /+\
  195.                              |O|
  196.                             /---\
  197.                            /_____\
  198.                             .. * 
  199.                             .   . 
  200.                              *  .
  201.                             .  . 
  202.                              .
  203.  
  204.